Api.ConfigureDc 方法
配置分布时钟 (DC) 选项。分布时钟允许从站周期与 KINGSTAR 周期同步,强烈建议任何运动应用程式皆需避免震动。
- 主站偏移:参考时钟为 EtherCAT 网路中具有 DC 功能的第一个从站时钟。
- 总线偏移:参考时钟为主站时钟。
命名空间:IntervalZero.KINGSTAR.Local.Api
组合: IntervalZero.KINGSTAR.Local.Api (于 IntervalZero.KINGSTAR.Local.dll) 版本:4.4.0.0
语法
public KsError ConfigureDc(
bool Active,
bool CheckStatus,
bool MasterShift,
int ReferenceIndex
)
Public Function ConfigureDc(
Active As Boolean,
CheckStatus As Boolean,
MasterShift As Boolean,
ReferenceIndex As Integer
) As KsError
参数
Active
型别:bool
true:启用 DC 同步;false:停用 DC 同步。预设为 true。
CheckStatus
型别:bool
启动时启用 DC 抖动检查。同步完成后,装置会切到运作状态 (Op),此将会使启动过程增加 15 秒,预设为 true。
MasterShift
型别:bool
选择偏移模式。true:主站偏移;false:总线偏移,预设为 false。
总线偏移表示 EtherCAT 从站跟随主站(电脑)时钟;主站偏移表示从站与主站跟随称作 "参考时钟 (Reference Clock)" 的从站时钟。依预设,参考时钟为总线上第一个支援 DC 功能的从站。
注意:从站时钟相较于电脑时钟准确,因此主站偏移较为稳定。然而,主站偏移会修改电脑时钟的速度,此将影响电脑上所有的时间戳记,若电脑上同时使用其他通讯协定,此将产生问题。
ReferenceIndex
型别:int
选择作为参考时钟的装置。此参数为从站 ID,即装置的 EtherCAT ID,其对应于装置在 EtherCAT 回路中的位置。此 ID 以 0 为起始且不受别名影响。
注意:ReferenceIndex 尚未实作。
回传值
方法的回传代码。
备注
- 此方法须在 Create 或 CreateAsync 后及 Start 前呼叫。
- 停用 DC 检查虽可减少 10 秒的启动时间,但一旦系统启动,将不再保证同步准备就绪。当系统切到操作状态 (Op) 后,时钟需要约 1 分钟的时间进行同步。因此我们建议您维持 DC 检查启用状态。
- 在主站偏移下,从站较为稳定但主站较不稳定,请在必要时才使用主站偏移。
可用的 EtherCAT 状态
ecatOffline
范例
N/A
参见